home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / KORGI3 / FINDI3.DOC < prev    next >
Encoding:
Text File  |  1996-11-03  |  4.7 KB  |  154 lines
  1.         ******************************
  2.               FINDI3 v1.0 
  3.                  (DOS)
  4.     
  5.             search names in KORG files
  6.               by Guenter Nagler 
  7.                 1996 
  8.           (gnagler@ihm.tu-graz.ac.at)
  9.         ******************************
  10.  
  11. [1] BACKGROUND
  12. KORG i2/i3 keyboards store can their data on 720KB floppy disks in
  13. files with extensions 
  14.    *.pcg  program data (64 programs + 2 drum kits)
  15.    *.sty  style data  (4 styles)
  16.    *.arr  arrangement data (64 programs)
  17.    *.sng  song data (10 songs)
  18.    *.bsq  backing sequence data (10 backing sequences)
  19.  
  20. All stored entries have a name (10 characters).
  21. When you have a lot of such files finding certain arrangements
  22. will be not easy because KORG shows the names only after loading
  23. which takes long time.
  24. This utility should help me find names in my Korg files.
  25.  
  26. [2] FILES DESCRIPTION
  27.  
  28. FINDI3.EXE..........MSDOS executable for korg i3 name search
  29. FINDI3.DOC..........this file, showing usage of FINDI3.EXE
  30. only FINDI3.EXE is required to run program 
  31.  
  32. [3] COPYRIGHT
  33.  
  34. FINDI3 (c) 1996 was created by Guenter Nagler.
  35.  
  36. FINDI3 is free and may be used as you wish with this one exception:
  37.  
  38.     You may NOT charge any fee or derive any profit for distribution
  39.     of FINDI3.  Thus, you may NOT sell or bundle FINDI3 with any 
  40.     product in a retail environment (shareware disk distribution, CD-ROM,
  41.     etc.) without permission of the author.
  42.  
  43. You may give FINDI3 to your friends, upload it to a BBS, or ftp it to
  44. another internet site, as long as you don't charge anything for it.
  45.  
  46. [4] DISCLAIMER
  47.  
  48. FINDI3 was designed to search names in standard KORG i3 files.
  49.  
  50. Use FINDI3 at your own risk.  Anything you do with FINDI3 is your
  51. responsibility, and not the author's.  Any damage caused to any person,
  52. computer, software, hardware, company, or business by running FINDI3 
  53. is your responsibility, and the author will not be liable.
  54.  
  55. If you don't understand these terms, or are not sure of something, or
  56. are afraid something bad might come of using FINDI3, don't  use  it!
  57. You are here forewarned.
  58.  
  59. [5] INSTALLATION 
  60.  
  61.   Simply copy FINDI3.EXE in a directory that is in your path.
  62.   When you start the program without arguments
  63.  
  64.   C:\> FINDI3 -h
  65.  
  66.   you should get the usage text (see next section)
  67.  
  68. [6] USAGE
  69.  
  70. findi3 searches names in korg files
  71. usage: findi3 [-h] [-p] [-m filemask] name ...
  72. -h or -?    show this usage information
  73. -p        pause screen after each page
  74. -m filemask    search only in files matching filemask (default: *.*)
  75. name can contain wildcards (*,?)
  76.  
  77. name is a word or simple regular expression (*, ?).
  78. The search will automatically do prefix search i.e. it will automatically
  79. append a * to the word. This will find all names beginning with the 
  80. specified word.
  81. It is allowed to specify more than one name. FINDI3 searches with logic-OR
  82. (find all entries that match any of the names)
  83.  
  84. wildcards for search:
  85. *    matches 0 or more characters
  86. ?    matches exactly one character
  87.  
  88. search is caseinsensitive (upper letters are treated as lower letters).
  89.  
  90. If no name is specified then * is assumed.
  91.  
  92. [7] OUTPUT MESSAGES
  93.  
  94. If no korg files are available or no file matches the filemask specified
  95. with option -m then FINDi3 writes:
  96. No KORG files found
  97.  
  98. When no name is found in any of the Korg files then
  99. FINDI3 stops with message:
  100. No matching names found.
  101.  
  102. Otherwise FINDI3 writes following lines:
  103. Name          Loc    Filename
  104. --------      ---    --------
  105.  
  106. Loc has different format for the file types:
  107. PCG ....... D11-D88 (bank D on KORG i2/i3 contains user programs)
  108. STY ....... U1-U4  (4 user styles on KORG i2/i3)
  109. ARR ....... A11-A88
  110. SNG ....... S0-S9
  111. BSQ ....... BSQ0-BSQ9
  112.  
  113. Warning: FINDI3 ignores all files that are not KORG type 9 (i2/i3)
  114. and empty *.SNG and *.BSQ files.
  115.  
  116.  
  117. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  118.  
  119.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  120.           contains all my dos/unix midi programs
  121.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  122.  
  123. [9] EXAMPLES
  124.  
  125. get a listing of all names in all korg files in current directory
  126. C:\> findi3 > names.txt
  127.  
  128. The listing will be written to the file names.txt
  129.  
  130. find all flutes
  131. C:> findi3 -p *fl*t* 
  132. Name          Loc    Filename
  133. --------      ---    --------
  134. FluteClar     D71    KORG.PCG
  135. Air Flute     D44    HIGH.PCG
  136.  
  137. option -p would stop the listing if the current page is full
  138. the ? would allow variable spelling of flute in different languages
  139.  (e.g. flute, floete, ...)
  140.  
  141. find all names beginning with character a in files high.*
  142.  
  143. C:\> findi3 -m high.* a
  144. Name          Loc    Filename
  145. --------      ---    --------
  146. AOR Rock      A27    HIGH.ARR
  147. AfterHours    A62    HIGH.ARR
  148. AfricanJam    D37    HIGH.PCG
  149. AltoBreath    D41    HIGH.PCG
  150. Air Flute     D44    HIGH.PCG
  151. AnaSyn        D53    HIGH.PCG
  152. Analogist     D56    HIGH.PCG
  153. Aoud          D64    HIGH.PCG
  154.